/*
    This file is part of the substandard lisp implementation of Standard Lisp
    Copyright (C) 2011 Nicky Nickell

    substandard lisp is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

function std_return(a, env) {
  var u = a[0];

  throw new lisp_error(ERROR_RETURN, u);
}

/*---
name: return
arity: 1
rest: false
ftype: FTYPE_EXPR

argument-types:
  - CLASS_ANY

doc: |
  explaining what return is / how it is used!

tests: |
  (return 9) -r> RETURN out of context
...*/
